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ADP PROGRAM WRITEUP: RXWTHR 


Description 

CSSG*R1LIB.RXOTMR 

ASCII Standard FORTRAN IV 

FCCC UNIVAC 1100 

BATCH or DEMAND (132 characters) 

Refer to: Bradshaw, Larry S., and William C. 
Fischer. 1981. A computer system for scheduling 
fire use. Part I; The system. USDA For. Serv. 

Gen. Tech. Rep. INT-91. Intermt. For. and Range 
Exp. Stn., Ogden, Utah 84401. 

Introduction 

This writeup is designed to facilitate use of Program RXWTHR. Program RXWTHR is located 
in the USDA Forest Service Region 1 shared library of the Fort Collins Computer Center. This 
program was developed cooperatively by Systems for Environmental Management (SEM) and the Fire 
in Multiple Use Management Research, Development and Applications Program at the Northern Forest 
Fire Laboratory, Missoula, Mont. RXWTHR provides climatic summary, and two- and three-way 
co-occurrence tables from data in the National Fire Weather Data Library (NFWDL) . This writeup 
assumes the user is familar with data retrieval techniques from the NFWDL. Weather data is read 
from logical unit 15. If you are not familar with the data library, get details from Bradshaw 
and Fischer (1981), or from Furman and Brink (1975). This program may be used in the batch or 
DEMAND mode. The writeup covers only the batch mode. To run DEMAND, create a run stream via 
the QDATA and @ADD commands, 


PROGRAM 

LANGUAGE 

MACHINE 

USAGE 

PROGRAMED 


Input 

User input to program RXWTHR is structured by (1) directive blocks and (2) information 
paragraphs. There are from one to five information paragraphs within each directive block. 
There is one directive block for each station to be analyzed and for each multiple analysis of 
a single station. ^ 

A directive block is always begun by the NUMBER OF STATIONS card and ended with the RUN 
control card. The NUMBER OF STATIONS card is simply the number of stations (1-99) in card 
columns 1 and 2. The RUN card is simply the word RUN in columns 1 to 3 on the last card of a 
directive block. 

Information paragraphs within a directive block are set off by a control word and have 
from one to 15 trailing cards that provide information needed to execute the program. In 
RXWTHR these paragraphs are: 

STATION information (followed by three information cards) 

ACTIVITY information (followed by one information card) 

SUMMARY information (followed by one to 15 information cards) 

CO-OCCUR information (followed by one to five information cards) 

^^UFF information (followed by two to five information cards) 

The paragraphs may be entered in any order and are keyed by the capitalized words above begin- 
ning with column 1, Information that does not change from one directive block to the next 
(for multiple analyses) should not be entered in directive blocks following its original 
declaration. 



Int'oriiiation to construct these directive blocks and paragraphs is taken from the User 
Information sheets provided by program users (exhibit 1), Card punching instructions are con 
tained in exhibits 2, 3, 4, 5, and 6. 


Job Control Language 

The following deiines the job control language (JCL) needed to get weather data from the 
National Tire Weather Data Library and execute program RXIVTHR. If you do not know the location 
of the data file for tlie station to be analyzed, execute the following control coinntands: 

@ASG,A FIREDATALIB*PROGRAMS. 

^XQT FIREDATALIB*PROGRAMS . LISTFILES 


rhen pick the file that contains the station to be analyzed. If more than one station is to be 
analyzed, pick the file containing the lowest station number. The followinc seouence i 
the JCL to get data and execute RXIVTHR for the examples on pages 11-15. 


1. 0 RUN, PRIORITY JOBNAME, ACCOUNT, QUALIFIER, TIME, PAGES 

2. @ASG,A FIREDATALIB*PR0GRAMS , 

3. (aASG,A FIREDATALIB*21~24. 

4. (aUSE 2. ,FIREDATALIB*21-24. 

5. §ASG,UP QUALIFIER*PHILIP. 

6. 0USE 15. ,QUALIFIER*PHILIP. 

7. @XQT FIREDATALIB*PR0GRAMS.GETDATA2 


11. @FREE 2. 

12. @ASG,T 2. 

13. 9ASG,A CSSG*R1LIB. 

14. (aXQT CSSG*R1LIB.RXWTHR 

directive blocks go here (see below) 

15. QeOF 

16. 0FIN 


8. 24020755 24020777 

9. 24300260 24300277 
10. @EOF 


Note: Actual formats are: 
SSSSSSYB SSSSSSYE 

SSSSSS = 6 digit station code 
YB = Year data to begin 
YE = Year data to end 


analysis of the same station within 6 days 


would replace commands 


2 through 11 


0ASG,A QUALIFIER*PHILIP. 

QUSE 15., QUALIFIER*PHILIP, 

to obtain the same data for analysis from mass storage at FCCC. 

Example Of Input Stream for Two-Station Analysis by 
RXWTHR ^ 

02 (Number of Stations) 

STATION 

WEST GLACIER 240207 3200 46 3 

■itst I YEARS 1955 1978 

0601 0915 


DATES 




RXWTHR -- USER INFORMATION SHEET 


Total Number Different Stations in This Run 

User's Name _ .Subunit nnit 

n . 1 / ’ 

Pro J ect;;;;;^ 


Fire Weather Station Information : 
Elevation f t . , Latitude 

4/ 5/ 

Fuel model^ .Last frost ^ 

Year begin .Year end 


Station name ^ ,\}o, 

.Climate class^^l^ .Slope class^^^ 

.Grass type — \ annual .perennial 

) Date begin .Date end 


Site Adjustment Factors fif any) : 

Aspect ( l=north, 2='east, 3=south, lowest ). Site elevation 

Canopy cover ( l=open, 2 = closed ) 


ft. 


Duff/Soil Horizon Information (if 
Layer Duff /Soil Type Thickness 
i cm 


cm 


3 

4 


cm 

cm 


5 


cm 


Duff Moisture selected. See User's Guide, appendix D1 : 

* ]J Use up to 80 characters 

* 

* 2_/ See User's Guide, appendix C 

* 

* V See User's Guide, appendix B 

•k 

* £/ For NFDRS indices only. See User's Guide, 

* appendix A 

* _5/ For NFDRS indices only 

■*-^*->>******^*-k**'k**-k****-k-.. -Kifk-k-k-k-k-kkiiK-k-k’kifkkic-k-k-k-k-kifk-kit 


Summary Table(s) Requested (Select up to 15 ) : 

^State of the weather 

Temperature (degrees F) 

^Relative humidity (“s) 

IVind direction (8 point) 

^iVind speed (mi/h) 

.Max temperature (24 h, deg. F) 

Nlin temperature (24 h, deg. F) 

.Max relative humidity (24 h, «) 


_Min relative humidity (24 h, ^ 5 ) 
j’recip duration (last 24 h) 
_Precip amount (24 h. 0.01 in) 

_1 hour fuel moisture (%) 

10 hour fuel moisture (%) 

_NFDRS ERG 
NFDRS BI 

Duff Moisture (24 h average, %) 


^^iQ'^^^^^snce Table(s) Requested (If 2-way table desired leave last space blank. If 
selected. Wind Direction must always "be listed first.): 


1 

with 

with 

7 

with 

with 

3 

with 

with 

4 

with 

with 

5 

with 

with 


Exhibit 1.--RXWTHR User Information Sheet. Users’ guide and appendixes A, C, and D refer 

to Bradshaw and Fischer (1981). 
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CARD PUNCHING & 
VERIFYING 
INSTRUCTIONS 


CARD FIELD 


STATION INFORMATION 
PARAGRAPH *********** 


Station Name 


Symbol ^Function 


Duplicate 

Punch 

Skip 

Verify 

Left Justify 


■Bran 




PROGRAM NAME 
RXWTHR 


PROGRAM NUMBER DATE 

SOURCE DOCUMENT CARD FORM USED 


PREPARED BY 
LARRY BRADSHAW 


1 of 2 


REMARKS 


Station Number 


Station Elevation 


Station Latitude 


NFDRS Fuel Model 


NFDRS Slope Class 


Herbaceous Type 



ADJUST 


Site Aspect Code *** 


Site Elevation *** 


Site Cano 


* Needed only for runs 


60 I 60 


Punch STATION -- sets up reading 
sequence of next three cards 


Format 4A4, enter station name 


Format 16, enter AFFIRMS number 


Format F5.0, enter elevation (ft) 


Format 12, enter latitude (degrees) 


Format Al, enter model 


Format II, enter class (1-5) 


Format Al, enter A or P 


Format II, enter class (1-4) 


Format 14, enter M^^DD 


Format LI , enter T,F or blank 


Format LI, enter T,F or blank 


Format LI, enter T,F or blank 


Format II, enter code (1-4) 


Format F5 . 0 . enter elevation 


Format II, enter code (1-2) 


DRS IINDICES 



disk file (TAPE2) . next run is then 


t directive block computations. 


** SAVE is used to write! first! run 


a REPEAT run and reads from TAPE2 skipp 


***Needed only if site a ljustmmts are to be made ADJUST turns the option on, the 
following three items specify adjjstmenis. 


Exhibit 2.— Card punching instrubtions for RXWTHR Station Information paragraph. 




































































CARD PUNCHING & 
VERIFYING 
INSTRUCTIONS 


Symbol ^Function 

D Duplicate 

P Punch 

S Skip 

V Verify 

L Left Justify 


COLUMNS N 
TO C 


PROGRAM NAME 

[^XWTHR 


PROGRAM NUMBER 


SOURCE DOCUMENT CARD FORM USED 


GE 


PREPARED BY 

LARRY BRADSHAW 


2 of 2 


CARD FIELD 


SECOND CARD AFTER "STATipN” CONTROL CARD 


REMARKS 


Years of analysis 

1 

5 

Beginning year 

11 : 

14 

Ending year 

17 1 

20 



Punch 'YEARS 


Enter 19YY 


Enter 19YY 



Dates 

1 

5 

Beginning date 

11 

14 

Ending date 

17 

20 


Punch 'DATES' 


Enter MMDD to begin 


Enter NiMDD to end 



**** Remember that RljWTHR ijs lim[ited to a 5-mc|nth analysis per execution, 


For analyses of more -flhan 5 



i see Rage 10 of this report. 
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CARD PUNCHING & 
VERIFYING 
INSTRUCTIONS 

Symbol 

^Function 

PROGRAM NAME 

RXIVTHR 

D 

P 

S 

V 

L 

Duplicate 

Punch 

Skip 

Verify 

Left Justify 

PROGRAM NUMBER 

DATE 

SOURCE DOCUMENT CARD 

T’ORM USED 

PREPARED BY 

LARRY BRADSMAIV 

PAGE 

1_ Of 

CARD FIELD 

COL 

From 

UMNS 

TO 


FUNC. 

* 

REMARKS 







***************************** 

************************ 



111 




i 

1 

1 



■ 

IH 



! ! 
jACTIVITY INFORMATION PARAGRAPH 
— 1 


n 



I 1 





ACTIVITY control word 

1 

8 

8 

P • 

Punch ACTIVITY -- this card sets up a 

(This card is the first 





reading sequence of one trailing card. 

card of the paragraph,) 












ACTIVITY information 

1 

80 

80 

P 

Enter any information you wish printed 

l(This is the second and 

j 





at the top of each page of output. 

•last card of the ACTIVITi 





Input format is 20A4. 

jparagraph.) 












i*tt*** ********’><******** 

*********** **********^.j^^ 

















































Exhibit 3. -Card punching instructions for RXtVTHR Activity Information paragraph. 
















CARD PUNCHING & 
VERIFYING 
INSTRUCTIONS 


Symbol ^Function 


Dupl icate 
Punch 
Skip 
Verify 

Left Justify 


PROGRAM NAME 
RXWTHR 


PROGRAM NUMBER 


SOURCE DOCUMENT CARD FORM USED 


PREPARED BY 
LARRY BRADSHAW 



Exhibit 4. -“Card punching instructions for RXWTHR Summary Information paragraph. 








































CARD PUNCHING & 
VERIFYING 
INSTRUCTIONS 


CARD FIELD 


***********^************ 


_Synibol| ^Function 


Duplicate 

Punch 

Skip 

Verify 

Left Justify 





CO-OCCURRENCE INFORMATION PARAGRAPH 


CO-OCCUR CONTROL CARD 1 8 8 


(first card of paragraph' 



PROGRAM NUMBER 

S()URCE DOCUMENT CARD 

DATE 

FORM USED 

PREPARED BY 

LARRY BRADSHAW 

PAGE 

}_of 

REMARKS 


CO-OCCUR parameter cards 6 


(up to five] 



(Repeat for each of one 


to five tables. ) 



20 I L/P Enter first parameter from information 
sheet. 


20 L/P Enter second parameter from information 


sheet. 


20 L/P Enter third (if requested) parameter 


from information sheet, otherwise leave 


blank. 



End Paragraph input 


13 3 


Punch END 



Exhibit S.-Card punching Instructiohs for RXWTUR Co-occurrence Information paragraph. 
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CARD PUNCHING & 
VERIFYING 
INSTRUCTIONS 


CARD FIELD 



^Function 


Duplicate 

Punch 

Skip 

Verify 

Left Justify 


itMPiiii 


PROGRAM NUMBER 


COLUMNS I N 
C 



PREPARED BY 
LARRY BRADSHAW 


************************ 


DUFF INFORMATION PARAGRA 


This paragraph is oiily e 


either a SUMMARY or CO-OCCUR ta 


The paragraph consijts of a DUFF c 


layers of duff (NLAYER) aid theli NLAY 


(via code) and the thicknpss of the layer. 



vhen tqie DUFF [MOISTURE option is requested in 


n paragraph. 


card that also gives the number of 


iiat ion cards giving the type of duff 


Card 1. DUFF control 

1 

word and NLAYER 

12 



12 12 1 



Punch DUFF 


Enter number of layers (II) 


DUFF information cards (ojne f 




layer! NLAYER 


Punch type code from user information 


sheet, Format is F5.0, decimal is 


punched , 


Enter thickness. Format is F5.0, 


decimal is punched, units are centi- 


meters. 


************************* 

************************* 



Exhibit 6. --Card punching information for RXWTHR Duff Information paragraph. 
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ACTIVITY 


directive j BRIEF FIRE LEATHER SWMARIES FOR WEST GLACIER HEADQUARTERS 
SUMI'IARY 

' 

TEMPERATURE 

block ( 

WIND DIRECTION 

END 

CO-OCCUR 

WIND DIRECTION WIND SPEED 

TEMPERATURE RELATIVE HUMIDITY WIND SPEED 

END 
RUN 

02 

I STATION 

second 

PHILIPSBURG RS 243002 5280 46 3 

YEARS 1960 1977 

directive 

'dates 0501 0931 
ACTIVITY 

block 

DEMONSTRATION OF RXWTHR INPUT AND OUTPUT FOR PHILIPSBURG RS 

RUN 

0EOF 

@FIN 

Exhibits 7 and 8 present user information necessary for this two-station analysis. Out- 
put from the second dii'ective block is shown in exhibits 9, 10, 11, and 12. 

Analysis of Stations with More Than Five 
Months Weather Data by RXWTHR 



KXWTHR -- USER INFORMATION SHEET 


Total Number Different Stations in This Run ^2 

User’s Name COLONY .Subunit GLACIER NP .Unit NPS 

Project-^ Brief fire weather summaries for West Glacier headquarters 


Fire Weather Station Information : Station name GLACIER 240207 

Elevation 3200 ft., Latitude 46 .Climate class -^ 5 .Slope class-'^ 

Fuel model;^;; .Last frost ^ < Grass type — ^ : annual .perennial 

Year begin 1955 .Year end 1978 .Date begin 0601 .Date end 0915 

Site Adjustment Factors (if any) ; 

Aspect C l = north, 2=east, 3=south, 4=west ), Site elevation 

Canopy cover ( l=open, 2 = closed ] 


Duff/Soil Horizon Information (if Duff Moisture selected. See User’s Guide, appendix D) 


Layer Duff /So 11 Type Thickness 
1 cm 

7 


cm 


cm 


cm 


cm 


**** •^* ***** it if 

★ ^ 

* y Use up to 80 characters * 

* . * 

* 2/ See User's Guide, appendix C * 

* y See User's Guide, appendix B * 

* * 

* £/ Fot NFDRS indices only. See User's Guide, * 

J appendix A * 

t 5/ For NFDRS indices only * 

***'^*****************t!*-K:.-K-k*i<itifK**-kit*-iti!-i!-)c/,il!*i,ii,-SH,i,i,*itil 


Summary Table(s) Requested (Select up to 15 ) : 

State of the weather 

y T emperature (degrees F) 

Relative humidity 

^ W ind direction (8 point) 

Wind speed (mi/h) 

Max temperature (24 h, deg. F) 

^lin temperature (24 h, deg, F) 

(Max relative humidity (24 h, %) 


_Min relative humidity (24 h. %) 
_Precip duration (last 24 h) 
Precip amount (24 h, 0.01 in) 

^1 hour fuel moisture (%) 

_10 liour fuel moisture (%) 

NFDRS ERG 
NFDRS BI 

Duff Moisture (24 h average, ^s) 


Co-occurrence Table(s) Requested (If 2^way table desired leave last space blank. If 
selected, Wind Direction must always be listed first.) : ” 

1 WIND DIRECTION with WIND SPEED with 

2 TEMPERATURE with RELATIVE HUMIDITY with WIND SPEED 


_with 

_with 

with 


_with 

_with 

with 


1 

Exhibit 7. --User information for example of two -station analysis, first directive block. 



RXCTHR -- USER INFORMATION SHEET 


Total N'umber Different Stations in This Run 02 

User's Name BRADSHAW , Subunit FIRE LAB , Unit INT EXP STN 

Pro 3 ect — ^ Demonstration of RXWTHR output for Philiusbure Ranger Station 


Fire Weather Station Information ; 

Elevation 5280 ft. , Latitude 

Fuel model^^ , Last frost ^ 

Year begin I960 ,Year end 


PMILIPSBURG RS 


Station name 

2 / 

46 .Climate class— 


1977 


.Grass type 


.Date begin 


5/ 


; annual 
0501 


No, 


243002 


.Slope class— ^ 


. perennial 


.Date end 


0931 


Site Adjustment Factors [if any) : 

Aspect ( i=north, 2=east, 5=south, 4=west ). Site elevation ^ft. 

Canopy cover ( l=open, 2 = closed ) 


Duff/Soil Horizon Information (if Duff Moisture selected. See User's Guide, appendix D) 


Layer DuftVSoil Type Thickness 

1 cm 

■y 


cm 


cm 


cm 


*****************iir**i(r******'*'*'*'*****i((*** ***************** 
* * 

* * 

* Jy Use up to 80 characters * 

* * 

* 2_/ See User's Guide, appendix C * 

* * 

* V See User's Guide, appendix B * 

* ★ 

* £/ For NFDRS indices only. See User's Guide, * 

* appendix A * 

* _5/ For NFDRS Indices only * 

* * **■* ***•***********•*★**•*•„«*****•****•*•*********•******** 


Summary Table(s) Requested (Select up to 15 ) ; 

^State of the weather 

X T emperature (degrees F) 

^Relative humidity 

X W ind direction (S point) 

Wind speed (mi/h) 

.Max temperature (24 h, deg. F) 

.Nin temperature (24 h, deg. F) 

.Max relative humidity (24 h, “j] 


Min relative humidity (24 h, %] 
Precip duration (last 24 h) 
Precip amount (24 h, 0.01 in) 

1 hour fuel moisture (%) 

10 hour fuel moisture (%) 

NFDRS ERC 
NFDRS 81 

Duff Moisture (24 h average, ®a) 


^?lQ. 9 .?^.'rtence Tabl e(s) Requested (If 2 -way table desired le ave last space blank. If 
selected. Wind Direction must always be listed firstTTT 


1 WIND DIRECTION 


TEMPERATURE 


with WIND SPEED 


with 


with RELATIVE HUMIDITY 


with WIND SPEED 


with 


with 


with 


with 


with 


with 


Exhibit 8,— User information for example of two-station analysis, second directive block. 



10 DAy A'lO MO^ITHLY SUM'^ARIES Of •»aTEMO iRAT JRE »»» 

RE.ATIVE EREOUE^CY OF OCCURRE'JCE OF DAl.Y VALUES (1500 HSTl 

■(Ehonstrat ION OF rxwthr output for ohillpsburg ranger station 

PHILLIPSBURG RS (2A3002) 1960-1977 


TEMPERATURE (F) 


RERIOO 

BEGINS 

RELOW 

55 

55 

TO 

39 

60 

TO 

69 

6 5' 

T1 

69 

70 

TO 

79 

75 

TO 

79 

90 

TO 

89 

95 

TO 

89 

90 

TO 

99 

95 

AND 

ABOVE! 

N. DAYS 

MEAN 

SO 

median 

RANGE 

may 1 

53,9 

12.5 

11,5 

12,5 

2.9 

6,7 





109 

59.3 

1 1 .5 

52.6 

39 


79 

may 11 

19.9 

17.9 

1 9 . 7 

12.9 

9,2 

6 • h 





109 

57.3 

1 1 .0 

57,0 

30 


79 

MAY 21 

11.9 

19.6 

20.3 

12.7 

11.0 

5, 1 

.8 




118 

59, 1 

10.3 

59,0 

33 


89 

JUN 1 

?l ,B 

19,5 

13,6 

21.8 

16.9 

9,1 

2.7 




no 

62.0 

9.9 

69.0 

39 


82 

JUN 11 

25.7 

15.5 

7.3 

19.3 

13,8 

10. 1 

3.7 

^ *6 



109 

63.3 

11 .8 

69.1 

39 


88 

JUN 21 

13.2 

12.3 

9.9' 

15,1 

19.8 

13.2 

12.3 

9.7 



106 

67.7 

11.6 

69.0 

38 

* 

87 

JUL' 1 

1 .9 

5# ^ 

5 • S 

12.3 

20.3 

29,0 

19.6 

5.1 


,7 

139 

73,8 

8.0 

79.8 

52 


95 

JUL 11 

1.3- 

5.3 

6.7 

11.3 

15.3 

23.3 

22.0 

11.3 

3.3 


ISO 

75,1 

9,1 

76.1 

98 

• 

92 

JUL- 21 

.6 

1.2 

9.9 

8.5 

10.9 

23,6 

29.7 

19,9 

1.2 


165 

78.0 

7,5 

79.1 

52 

• 

90 

AUG 1 • 

1.9 

9.9 

3,9 

12.6 

16.9 

20.1 

21,9 

15.1 

3.B 

.S' 

159 

76.9 

9.2 

76.7 

so 

• 

95 

AUG 11 

2.1 

9.1 

5.2 

9,6 

13.0 

19.9 

23.3 

21.2 

,7 


196 

76.5 

9,3 

77,8 

95 


91 

AUG 21 

11.3 

3,1 

9.1 

1 1.9 

13.1 

22.5 

15.6 

6.9 

1.9 

.6 

160 

70.8 

11.6 

73.0 

91 

• 

95 

SEP 1 

23,1 

7,7 


15,9 

30.8 


7.7 

7,7 

7.7 


13 

67.9 

19.7 

69.6 

95 

- 

90 

MAY 

91.1 

16.1 

15.7 

12.7 

7.9 

6.0 

.3 




331 

57.0 

11. 1 

56.7 

30 


89 

JUN 

20,3 

19-,5 

10.2 

19.5 

16,6 

10. B 

6,2 

3.1 



325 

69.6 

11.3 

65.9 

39 

. 

88 

JUL' 

1.1 

9.0 

5.7 

10.6 

15.2 

25.2 

29,1 

12.9 

1.3 


953 

75,8 

8.9 

76.7 

98 


95 

AUG 

5.2 

5*6 

6.0 

1 1.9 

19.2 

20,9 

20.0 

19.2 

2.2 


965 

79,5 

10.5 

75,8 

91 


95 

SEP 

23.1 

7.7 


15.9 

30.8 


7.7 

7.7 

7.7 


13 

67.9 

19,7 

69.6 

95 

- 

90 


Exhibit 9, --Program RXIVTHR temperature summary output for second directive block in two-station 

analysis example. 


10 DAY and monthly SUMMARIES OF »»»,^iNO DIRECTtUN «*» 

RE.lATIVE FREQUENCY OF OCCURRENCE OF OAI.fT VALUES (1500 MSI) 

demonstration of RXWTHR output for rhillpssurg ranger station 

RHilLIPSBURO RS (293003) 1960-1977 


WIND direction 


period 

begins 

CALM 

NE 

E 

S*i 

S 

SW 

W 

NW 

N 

N. DAYS 

mode 

hay 1 

1 .9 

9.7 

1.9 

1 .9 

2.9 

26,9 

19.2 

28,8 

7.7 

109 

NW 

may 11 

1 .8 

3.3 

1.9 

1.9 

l.B 

22.9 

20.2 

27.5 

13. B 

109 

NW 

MAY 21 

.8 

3.9 

.3 

2.5 

.9 

29.7 

12,7 

38.1 

11.0 

118 

NW 

JUN 1 

5,5 

5,5 

3.5 

9.5 


18.2 

19,5 

39.1 

9.1 

no 

NW 

JUN 11 

3.7 

l.B 

9,6 

3.7 

1 .8 

26,6 

12.8 

30.3 

19.7 

, 109 

NW 

JUN 21 

5.7 

9,7 

2.9 

1.9 

3,8 

25.5 

17,9 

26,9 

11,3 

105 

NW 

JUL- 1 

2,9 

5,9 

2.2 

2.9 

.7 

25,9 

15,9 

29,7 

19.5 

138 

NW 

JUL n 

3.3 

5,3 

2.0 

2.0 

7,3 

22.0 

15.3 

27.3 

15,3 

150 

NW 

JUb 21 

1.2 

9-, 8 

1.2 

2.9 

3.0 

20.6 

20.0 

37,6 

9.1 

165 

NW 

AUG 1 

1.9 

9.9 

1.3 

9.9 

1.9 

30,2 

12.5 

30.8 

7.5 

159 

NW 

AUG 11 

2,7 

1*4 

1.9 

1,9 

1.9 

2B.1 

17.8 

19,7 

6,2 

196 

NW 

AUG 21 

2.5 

3.8 

.6 

2,5 

9.8 

23,1 

18.8 

32,5 

7.5 

160 

NW 

SEP 1 





7.7 

15,9 

96,2 

30.8 


13 

W 

MAY 

1.5 

6.6 

1.5 

2.1 

1.8 

26.6 

17.2 

31.7 

10.9 

331 

NW 

JUN 

9.9 

9,0 

3.7 

3.9 

1 .8 

23.9 

15,1 

32.0 

11.7 

325 

NW 

JUU 

2.9 

5.3 

1.9 

2,9 

3.8 

22.5 

17.2 

31,8 

12.8 

953 

NW 

AUG 

2.9 

9,9 

1.1 

2.9 

9.1 

27,1 

16,3 

39.2 

7,1 

965- 

NW 

SEP 





7.7 

15,9 

96.2 

30,8 


13 

W 


Exhibit 10. --Program RXIVTHR wind direction summary output for second directive block in two - 

station analysis example. 
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WI^|0 OI^ECTKJN 


Vnn SPFEO 


PERCENT FREQUENCY OF CO- OCCURRENCE 
GIVEN TO tenths PERCENT 

RHiLLlPSaURG RS (E^OOO?) 19bO-lR77 


OENONSTRaTlON OF RXi^THR OUTPUT FOR PHI LL TPS0URG RANGER STATION 


*# MAY 




3 

WIND 

6 

SPEED 

9 

12 

15 

MPH 

13 

21 

24 

28 

I 

OIR 

Below 

TO 

TO 

TO 

TO 

TO 

TO 

TO 

TO 

AND 

I 


3 

5 

8 

11 

14 

17 

20 

23 

27 

ABOVE 

I TOTAL 
'I * 


calm 

I 1.5 








I 

1.5 

I 

NE 

I 2.7 

1.8 

.3 

1.2 


.3 


.3 

I 

6.6 

I 

E 

I ,3 

. 6 

.3 


.3 




I 

1.5 

I 

5E 

I .3 

.9 

.6 


.3 




I 

2.1 

I 

S 

I .3 

.3 

.3 

.9 





I 

1.8 

I 

SW 

I .9 

9,7 

5, 1 

4,2 

3.6 

2.1 

,9 


I 

26.6 

I 

w 

I 1.3 

l.B 

6.6 

2.4 

3.6 

.9 



I 

17.2 

I 

NW 

I 1.5 

9.4 

7,9 

4.B 

3.6 

3.6 

. 6 

.3 

I 

31.7 

I 

N 

I ,3 

1.5 

3.3 

3,0 

1 .« 

.6 

,3 


I 

10.9 

I 


I I I 


TOTAm I 9,7 26.0 2A,5 16,5 13.3 7 , &■ 1 ,R ,6 0. 0, I 100.0 I NUNRER OF DAYS 331 


JlJ^J »# 


WIND SPEED MPH 


OTR 

Below 

3 

r« •• w. 

3 

TO 

5 

6 

to 

8 

calm 

I 4.9 



NE 

I .3 

1.8 

.6 

£ 

I ,3 

.9 

1.2 

SE 

I .6 

1.2 

,6 

S 

I 

.9 

,3 

SW 

I 4.9 

6,5 

3.1 

w 

I .6 

4.6 

2.8 

NW 

I 2.8 

7.7 

8.9 

N 

I .3 

I-...... 

2.2 

4,0 

total- 

I 14.8 

25.8 

21.5 


9 

12 

15 

18 

21 

TO 

TO 

TO 

TO 

TO 

11 

14 

17 

20 

23 


,9 

.3 


,9 

.3 


.3 

• ft 

,6- 

4.3 

I .« 

1.2 1.5 

3. 1 

3.7 

.3 

6.3 

4.9 

.6' .3 

1.5 

.9 

2.5 

17,3 

12.6 

5.2 1.8 U. 


24 2B I 

TO AND I 

27 ABOVE I TOTAL I 

I I 

I 4,9 I 
I 4,0 I 
I 3.7 1 
I 3.4 I 
I 1.8 1 
I 23.4 I 
I 15.1 I 
I 32.0 I 
.3 I 11,7 I 

I I 

,3 0, I 100.0 I number of days 


325 


Exhibit 11. --Program RXWTHR two-way co-occurrence output (wind direction and windspeed) for 
second directive block in two-station analysis example. 


PHltLlPSnj^r, RS (341008) 
«» MAY *0 1960-1077 


TEMPERATjpe - relative HUMniTY - WHO SPEEO 

percemt freooency of cd-occijrren:e. oivem to tenths percent 


demonstration of RXjITHR output for PH'ILL IPSaURG RANGER STATION 


NINO SPEED 

RELATIVE HUHIDITY 


LT 


6 MPH 


TEMP 

(F) 


RELON 

1 10 
• I 

10 

TO 

19 

80 

TO 

89 

30 

TO 

39 

40 

TO 

49 

50 

TO 

59 

60 

TO 

69 

70 

TO 

79 

80 90 

TO AND 

89 ABOVE 

LT 

55 

I 



.6 

1.5 

3.6 

1.8 

3.3 

2.4 3.0 

55 - 

59 

I 


.6 

.6 

2.4 

1.8 

.6 


.3 

60 - 

64 

1 


.6 

i.a 

1 .8 

.6 

.3 

.3 


65 - 

69 

1 


1.8 

8.1 

.6 


.3 



70 - 

74 

I 

.6 

.9 

.6 


.3 




75 - 

79 

I 

.3 

1.2 


.3 






I 

I 

NINO 

SPEEO 



6 

- 11 

MPH 



I 

RELATIVE 

HJHIOITY 

% 





I 

10 

20 

30 

40 

50 

60 

70 

80 

90 

I RELON' 

TO 

TO 

TO 

TO 

TO 

TO 

TO 

TO 

ANO 

I 10 

19 

89 

39 

49 

59 

69 

79 

89 

above 

I 


.3 

1.2 

3.3 

2.4 

3.6 

3.0 

2 . 

.9 

I 

.6 

1.8 

3.3 

1.2 

.3 

.3 




I 

.3 

1.5 

8.7 

.6 

.9 





I 

.6 

1 .8 

1.2 

.9 






1 

.3 

2.1 

.9 

.3 






1 

1 .5 

1.2 

.3 








ao 

85 

90 


GE 


B4 I 
89 I 

94 I 

95 1 


total I 

0 . 1.2 4.5 

5.7 

6,6 

5,7 

8.4 

3.6 8,7 3.0 I 

0, 3,3 8,8 

9,7 

6.3 

3.6 

3.9 3,0 2,1 ,9 

TEMP 

I 

.—-I 

WIND SPEEO 



18 

- 17 

MPH I 

WIND SPEED 



18 - 

23 M3H 

LT 

55 I 


.9 

1 .8 

.9 

1 .5 

1,2 .9 I 


.3 

,3 


,3 ,3 

55 - 

59 I 

.6 

.9 

,9 

.6 

.3 

I 


.3 




60 - 

64 I 

.3 ,9 

1.2 

.6 


.3 

.3 I 


.3 


,3 


65 “ 

69 I 

,9 

1.8 

,3 

.3 


.3 I 


.3 




70 - 

74 I 

1.8 





I 






75 - 

79 I 

1.2 





I 

I 






80 - 

84 I 











85 - 

89 I 






I 






90 - 

94 I 






I 






GE 

95 I 
1 






I 







total I 


.3 0 . 


5.4 4. a 3.6 1.3 ?.l 1.8 .9 0. I 


0 . 


0 . 


0 . 


1.8 


.3 


0. 0, I 


TEMP I NINO SPEEO GE 24 MPH I TOTAL 1 


LT 

55 I 

I 41.1 

55 “ 

59 I 

1 16.3 

60 - 

64 I 

I 15.7 

65 - 

69 1 

I 18.7 

70 - 

74 1 

I 749 

75 - 

79 I 

I 6.0 

80 - 

84 I 

I . 3 

85 - 

89 I 

I 0 . 

90 - 

94 I 

( 0 . 

OE 

95 I 

I 0 . 


total I 0. 0. 0. 0. 0, 0. 0. 0. 0. 0. I lOO.O I NUHdER OF DAYS 331 


Exhibit 12 . --Program RXWTMR three-way co-occurrence output (.temperature, relative humidity and 
windspeed) for second directive block in two-station analysis example. 
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Error Messages 

1 . Control sequence incorrect, program aborted . 

Cause: A control card was read that was uninterpretable by the program's internal diction- 
ary. Misspelled control words or failure to start the word in column 1 o£ the 
control card are the most common causes. Can also be caused by not placing an END 
card at the end of an option series. 

2 . No summary or co-occurrence option specified, program aborted . 

Cause: There is neither a SUMMARY nor a CO-OCCUR control card in the input stream. 

Station numbers on descriptor card and data file do not matcli, program aborted . 

Cause: Keypunch error on STATION card following STATION control card, or error in data 
file structure. Remember that stations must be analyzed in ascending order. 

4 . At least one summary option card is incorrect, program aborted . 

Cause: One of the option cards trailing the SUMMARY control card is misspelled or does 
not begin in column 6. 


^ ■ ^t least one co-occurrence option card is incorrect, program aborted . 

Cause; One of the option cards trailing the CO-OCCUR control card has a misspelled word, 
or the words do not begin in the correct columns. The correct columns are 6 and 
31 for two-way tables, and 6, 31, and 56 for three-way tables. 

between site and AFFIR M S station greater than 2000 feet, no adjustments made . 

Cause: IVhen using ADJUST option, elevation differences are limited to 2000 feet. Program 
executes, but without any site adjustments. 

than 5 mo nths weather summary requested, only first 5 montlis nrocessed . 

Cause: Self-explanatory - Split data into two or three sections. 


Output Quantity 

For each station, the following output is produced: 

SUMMARY tables: One (1) page for each parameter requested. 
CO-OCCURRENCE tables: 


Two-way: 


Three-way; 


2-month analysis (for example, a two- 
way table from May through August will have two pages of output) 

One (1) page for each table for each month's analysis (for example 
of oitputT through September will produce five page 


Cost Estimates 

co-occurrenc^'tabLsra^usercan^Lpecrcok^anriesr^^^^^’ summary tables, two to thre( 

wctn expect costs and resource use as outlined below: 



Run Priority 

Cost 

CAU (sec) 

Resource 

time 

DEMAND 

$6.00 - $7.00 

14 - 15 

22 - 

25 

L 

$3.00 - $4.00 

14 - 15 

22 - 

25 

M 

$2.00 - $3.00 

14 - 15 

22 - 

25 

P 

$1.00 - $2.00 

14 - 15 

22 - 

25 


ADP PROGRAM WRITEUP; RXBURN 


Description 

CSSG*R1LIB. RXBURN 
ASCII StanciaTd FORTRAN IV 
FCCC UNIVAC 1100 

BATCH or DEMAND (132 characters) 

Refer to: Bradshaw, Larry S., and William 
C. Fischer. 1981, A computer system for 
scheduling fire use. Part I; the system. 

USDA For. Serv. Gen, Tech. Rep. INT-91. 

Intermt. For. and Range Exp. Stn., Ogden, 

Utah 84401. 

Introduction 

This writeup is designed to facilitate use of program RXBURN. This program is located 
in the USDA Forest Service Region 1 shared library at the Fort Collins Computer Center. RXBURN 
summarizes occurrence frequencies of user-defined prescribed fire conditions. The program oper- 
ates on data from the National Fire Weather Data Library (NFWDL) . This writeup assumes the user 
is familiar with techniques for accessing this data. Weather data are read from logical unit 15. 
If you are not familiar with these procedures see Bradshaw and Fischer (1980) or Furman and Brink 
(1975). This program may be used in either the batch or demand mode. Batch is covered in 
this writeup. Demand users should create run streams via @DATA and @ADD commands and run 
programs the same as batch. 

Input 

User input to RXBURN is structured by (1) directive blocks and (2) by information para- 
graphs within the directive blocks. There are from one to five information paragraphs within 
each directive block. Multiple-station or prescription analysis is obtained by "stacking" 
directive blocks. 

A directive block is set off by a NUMBER OF STATIONS card and ended by a RUN card. The 

NUMBER OF STATIONS card is simply a card with the number of stations in columns 1 and 2, Up 

to 99 stations may be analyzed in a single run. The format is 12. The RUN card is simply 

the word RUN in columns 1 through 3 after all information has been read in the information 

paragraphs. 

Information paragraphs within the directive blocks are set off by a control word beginning 
in the first column of the card and are followed by from one to 15 information cards, depend- 
ing on the type of information. 


PROGRAM 

LANGUAGE 

MACHINE 

USAGE 

PROGRAMED 
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Frogratn RXBURN accepts the following words to set off information paragraphs: 


STATION 

ACTIVITY 

IDENTIFY 

PRESCRIBE 

DUFF 


information (followed by three information cards) 
information (followed by one information card) 
information (followed by one information card) 
information (followed by one to 15 information cards) 
information (followed by from two to five information cards) 


The paragraphs may be entered in any order within a directive block, and information not 
changing from one directive block to the next (multiprescription or station analyses) does not 
need to be reentered in subsequent directive blocks. 


Information needed to construct these directive blocks is taken from the user information 
sheets provided by program users (exhibit 13) . Card punching instructions are contained in 
exhibits 14, 15, 16, 17, and 18. 

Job Control Language 

The following defines the job control language (JCL) needed to get weather data from the 
National Fire Weather Data Library and execute program RXBURN. If you do not know the location 
of the data file for the station to be analyzed, execute the following control commands; 


@ASG,A FIREDATALIB*PROGRAMS. 

@XQT FIREDATALIB*PROGRAMS . LISTFILES 


Then pick the file that contains the station to be analyzed. If more than one station is to be 
analyzed, pick the file containing the lowest station number . The following sequence illustrates, 
the JCL to get data and execute RXBURN for the examples on pages 27-30, 


1. 

ORUN , PRIORITY JOBNAME , ACCOUNT , QUALIFIER, TIME , PAGES 

2. 

@ASG,A FIREDATALIB*PROGRAMS . 


3. 

@ASG,A FIREDATALIB*21-24. 


4. 

Ouse 2. ,firedatalib*21-24. 


5. 

@ASG,UP QUALIFIER*PHILIP 


6 . 

0USE 15. ,QUALIFIER*PHILIP 


7. 

0XQT FIREDATALIB*PR0GRAMS.GETDATA2 

Note: Actual formats are: 

8. 

24300260 24300277 

SSSSSSYB SSSSSSYE 

9. 

@EOF 


10. 

0FREE 2. 

SSSSSS = 6 digit station code 

11. 

@ASG,T 2. 

YB = Year data to begin 

12. 

@ASG,A CSSG*R1LIB. 

YE = Year data to end 

13. 

@XQT CSSG*R1 LIB. RXBURN 


14. 

@EOF 


15. 

@FIN 



Subsequent analysis of the same station within six days would replace commands 2 through 11 

with: 

@ASG,A QUALIFIER*PHILIP. 

OUSE 15., QUALIFIER*PHILIP, 

to obtain the same data for analysis from mass storage at FCCC. 




RXBURN 


USER INFORMATION SHEET 


Total Number Different Stations in This Run 


User' s Name 
Proj ect— ^ 


, Subunit 


,Unit 


Fire Weather Station Information: Station name 


,No, 


Elevation 

ft . , Latitude 

3/ 

.Climate class- .Slope class- 



4/ 

Fuel model— 

5/ 

, Last frost— 

^ 5/ . , 

.Grass type-; annual .perennial 



Year begin 

,Year end 

.Date begin .Date end 



Site Adjustment 

Factors (if any) ; 




Aspect ( 

i=north, 2=east, 

3=south, 4=west ), Site elevation 

ft. 


Canopy cover 

( l=open, 2- 

'dosed ) 



Duff/Soil Horizon Information (if Duff Moisture selected. See User's Guide, Appendix 

D): 


Layer Duff/Soil 

1 

Type Thickness 

cm 

***•**’**•**•***•*★•****•********★**•***•*********** ^•^•A’*'***********^* 

* ’V 

* 1/ Use up to 80 characters * 

2 

cm 

* 

* 2/ See User's Guide, appendix C 


A 

* 

it 

3 

cm 

* 

* 3/ See User's Guide, appendix B 


* 

* 

* 

4 

cm 

■k 

* 4/ For NFDRS indicies only. See User's Guide, 


* 

* 

* 

5 

cm 

* , appendix A 

* £/ For NFDRS indices only 


* 

it 

it 


ifirir it *k if if 'if ifitieif’kitititir'kic 


Prescription Factor Selections (Check and set limits for up to 15 factors.) 

Preferable Rx 

Factor Minimum Maximum 

State of the weather, 

^Temperature (deg. F) 

Relative humidity 


_Wind direction (8 point) 

_Wind speed (mi/h) 

Max temperature (24 h, deg. F) , 
jMin temperature (24 h, deg. F) . 
Max relative humidity (24 h, %) 
Min relative Immidity (24 h, %) 
Days since last precipitation., 
Precip amount (24 h, 0,01 in).. 

1 hour fuel moisture (%) 

10 hour fuel moisture (%), 


NFDRS ERG, 


.NFDRS BI, 


Acceptable Rx 
Minimum Maximum 


Duff moisture (24 h average, %) 


Exhibit 13. --RXBURN User Information Sheet. User's guide and appendixes A, B, C, and D refer 

to Bradshaw and Fischer (1981), 
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CARD PUNCHING & 
VERIFYING 
INSTRUCTIONS 

KBBI 

^Function 

“PRO'GRAM NAME 

RXBURN 

■ 

Duplicate 

Punch 

Skip 

Verify 

Left Justify 

PROGRAM NUMBER 

DATE 



SUURLt UULUMhNI CARD FORM USED 

PREPARED BY 

LARRY BRADSHAW 

PAGE 

I_ 0^ _2 

CARD FIELD 


iia 


■ 

REMAR 

KS 

STATION INFORMATION 
PARAGRAPH*************- 

iShEBEb 

!■ 

7 

* * * * * * 


Punch STATION -- sets up reading . 
seauence of next tliree rnrrl*^ 

Station Name 

1 

16 

16 

P 

Format 4A4 . entcT at inn namn 

Station Number 

17 

22 

6 

■1 

Format 16. enter AFFIRMS nnmhpr 

Station Elevation 

24 

28 

5 

HI 

Foi'mat F5.0. enter elevation fftl 

Station Latitude 

30 

31 

2 

P 

Format 12, enter latitude fflewreet;) 

NFDRS Fuel Model 

33 

33 

1 

P 

Format A1 , enter model 

NFDRS Slope Class 

35 

35 

1 

P 

Format 11, enter class 11-51 

Herbaceous Type 

37 

37 

1 

P 

Format Al, enter A or P 

NFDRS Climate Class 

39 

39 

1 

P 

Format 11, enter class (1-41 

Date of Greenup * 

41 

44 

4 

P 

Format 14, enter MMDD 

REPEAT ** 

T~ 

46 

46 

1 

P 

Format LI, enter T,F or blank 

SAVE ** 

48 

48 

1 

P 

Format LI, enter T.F or blank 

ADJUST *** 

50 

50 

1 

P 

Format LI, enter T,F or blank 

Site Aspect Code *** 

52 

52 

1 

P 

Format 11, enter code (1-41 

Site Elevation *** 

54 

58 

5 

P 

Format F5.0, enter elevation 

Site Canopy Cover *** 

60 

60 

1 

P 

Format 11, enter code (1-2) 

* Needed only for runs 

lith N 

'DRS I 

'JDICES 



** SAVE is used to write 

first 

run c 

jmputat 

ion to 

iisk file (TAPE2) , next run is then a 

REPEAT run and reads f 

rom Tj 

iPE2 s 

cippinj 

first 

irective block computations. 

*** Needed only if site ad 

justmi 

-nts at 

’e to 1 

e made. 

ADJUST turns the option on, the 

following three items 

sped: 

V adj 

istment 

3 1 









Exhibit 14.-Card punching instructions for RXBURN Station Information paragraph. 
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CARD PUNCHING & 
VERIFYING 
INSTRUCTIONS 


^Function 


Duplicate 

Punch 

Skip 

Verify 

Left Justify 


PROGRAM NAME 

RXBURN 


PROGRAM NUMBER 


SOURCE DOCUMENT CARD FORM USED 


PREPARED BY 

LAURY BRADSHAW 


CARD FIELD 


SECOND CARD AFTER "STATT 


TO C 


TROL 


REMARKS 


Years of analysis 


Beginning year 


Ending year 


1 

5 

11 

14 

17 

20 


5 P 


Punch 'YEARS' 


Enter 19YY 


Enter 19YY 


THIRD CARD AFTER "STATIO 


Dates 

1 

Beginning date 

11 

Ending date 

17 


Punch 'DATES' 


Enter MMDD to begin 


Enter MMDD to end 


********** * * * * * * * * * * * * * * 
* * * * * * * * * * * * * * * * * * * * * * * * 


Exhibit 14, --(continued) 



































CARD PUNCHING & 
VERIFYING 
INSTRUCTIONS 


CARD FIELD 


Symbol ^Function 
D Duplicate “ 
P Punch 

S Skip 

V Verify 

L Left Justify 


CULUMNS NO. [FIInT 

\ TO COLS. * 


PROGRAM NAME 

RXBURN 

PROGRAM NUMBER 


"SUURCE DOCUMENT CARD FORM USED 


“prepared by 

LARRY BRADSI-lAW 


1 Of 1 


REMARKS 




[activity information paragraph 


ACTIVITY control word 
(this card is th e first 
card of the paragraph) 


18 8 


^ Punch ACTIVITY -- this card sets up a 
reading sequence of one trailing card. 


ACTIVITY information 

i_ - 

(this is the second and 
last card of the ACTIVITY 
paragraph) 


80 80 


Enter any information you wish printed 
at tlie top of each page of output . 
Input format is 20A4. 


* * * * *T***T**T*F;r*7?*Ti*tr 
**********************^^ 


Exhibit 15, -Card punching instructions for RXBURN Activity Information paragraph. 



CARD PUNCHING & 
VERIFYING 
INSTRUCTIONS 


"^Function 

PROGRAM NAME 

RXBURN 

Munm 

Duplicate 

Punch 

Skip 

Verify 

Left Justify 

PROGRAM NUMBER 

DATE 

SOURCE DOCUMENT CARO FORM USED 

PREPARED BY 

LAIUIY BRADSHAW 

PAGE 

i_of 

CARD FIELD 

COLUMNS 1 



REMARKS 

mi 

im 



■ 

n 



*Jt *A* *A* "k A* *A* A’ A A A* A* A A A’ A A* A A A* A A A* A’ 

A* A A A A A A* A' A A* A A A A A A* A A A A A A A A 

IB 

■ 





H 





IDENTIFY INFORMATION PAR 

QHQ 

Bf 









Bl 


Card 1 

1 

8 

8 

■1 

Punch IDENTIFY 

Card 2 information inp 

it 





User name 

1 

20 

20 

■i 

Enter user's name 

District 

21 

40 

20 

■I 

Enter district 

Forest 


60 

20 

n 

Enter forest 



nn 

■1 




■ 

■ 

































































Exhibit 16. --Card punching instructions for RXBURN identify Information paragraph. 
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CARD PUNCHING & 
VERIFYING 
INSTRUCTIONS 



^Function 


Duplicate 

Punch 

Skip 

Verify 

Left Justify 


CARD FIELD 


iTHflllJgfMIMK 


NO. FUNC, 
TO I COLS. * 


PROGRAM NAME 

RXBURN 


PROGRAM NUMBER 


SOURCE DOCUMENT CARD FORM USED 


PREPARED BY PAGE 

LARRY BRADSHAW 


REMARKS 


************* ************* 
************************** 



PRESCRIPTION INFORMATION PARAGI 


s prescriptions for program analysis. 


The first card sets up a reac ing stiquence of NPaIm trailing cards, NP ARM "has a value 


from 1 to 15. 


Card 1. PRESCRIBE -- NPARM 1 


enter NPARM 


RM 1 

9 

1 ^ 

11 

12 

2 



Information card(sl -- ore for each 


6 30 


Parameter 


Preferred Minimum ValuJ 33 35 


Preferred Maximum Value 38 40 


Acceptable Minimum Valte 43 45 


imum Valie 48 50 



Punch PRESCRIBE 


Enter total number of parameters in tlie 



ustified 


rameter . 



P/L Enter factor from information sheet 


Enter value (right justified) 


Enter value (right justified) 


Enter value (right justified) 


Enter value (right justified) 



nunchi nci i n<;t T'lir-hi DVDI IDM n i 














































[RIHH 

^Function 

PROGRAM NAME 

RXBURN 

CARO PUNCHING & 
VERIFYING 
INSTRUCTIONS 

1 

Duplicate 

Punch 

Skip 

Verify 

Left Justify 

PROGRAM NUMBER 

DATE 

SOURCE DOCUMENT CARD FORM USED 

PREPARED BY 

LARRY BRADSHAW 

PAGE 

i_ of 

CARD FIELD 

■TifiiwigigaM: 

ngBI 

-UNC. 

* 

REMARKS 


TO 

•A A A ★ A A A A A A A A A A A A A A A A A ★ A 

A A A A A A A A A A A A A * A A A A A A A A A 

■ 











DUFF INFORMATION PARAGR/ 






This paragraph is c 

nly ei 

itered 

wlien t 

le DUF 

’ MOISTURE option is requested as a 

parameter in the PI 

ESCRI 


informa 


iragraph . 

The paragraph consi 

StS 0 

Bi 

■I 


'd card that also gives the number 

of layers of duff ( 

NLAYEl 

0 and 

then N 

.AYER 

.nformation cards giving the 

type of duff (via c 

ode) i 

ind til' 

j thick 

less 0 ; 

• the layer. 







Card 1. DUFF control 

1 

4 

4 

P 

Punch DUFF 

word and NLAYER 

12 

— 

12 

1 

P 

Enter number of layers (11) 







DUFF information cards { 

one f( 

ir eacl 

1 layer 

, NLAYl 

:R) 

Duff type 

— 

1 

5 

5 

P 

Punch t>T3e code from user information 






sheet. Format is F5.0, decimal is 






punched. 

Layer Thickness 

6 

10 

5 

P 

Enter thickness. Format is F5.0, 




1 


decimal is punched, units are centi- 






meters . 







*********************** 

*********************** 













Exhibit 18. --Card punching instructions for RXBURN Duff Information paragraph. 






















Example of Input Stream for One Prescription 


01 

STATION 

PHILIPSBURG RS 243002 5280 46 3 

YEARS 1960 1977 

' DATES 0510 1101 

{ ACTIVITY 

DEMONSTRATION OF RXBURN OUTPUT FOR PHILIPSBURG RANGER STATION 

{ IDENTIFY 

LARRY BRADSHAW FIRE LAB MONTANA 

I PRESCRIBE 03 

TEMPERATURE 65 75 60 80 

RELATIVE HUMIDITY 20 30 20 55 

WIND SPEED 4 9 0 15 

RUN 


@EOF 

§FIN 


Exhibit 19 presents user information necessary for this example, 
exhibits 20, 21, 22, and 23. 


Output is shown in 


Multiple Prescription Analysis 


Program RXBURN is structured such that two or more prescription conditions may be analyzed 
for frequency of occurrence in one run on the same weather station. 

^ This is accomplished by use of the SAVE and REPEAT options on the station information card 
in the RATION paragraph. The first directive block stores computed and observed parameter 
values by setting the SAVE option to TRUE. This is done with a "T” in column 48 of the station 
information card. 

Stored computations are then used in subsequent directive blocks, which does away with the 
need to reread and compute all data for a station. This is accomplished by a "T” in column 46 
of the second directive block. Third and subsequent directive blocks do not need the STATION 
paragraph entered. Remember, there is one directive block for each prescription analysis 



RXBURN -- USER INFORMATION SHEET 


Total Number Different Stations in This Run 


User's Name 

BRADSHAW 

FIRE LAB 


.Unit INT exp STN 

Project—^ Demonstration of RXBURN output 

for Philipsburg 

Ranger Station 

Fire Weather 

Station Information: Station name Philipsburg RS 

243002 

Elevation 

5280 ft., Latitude 46 

■?/ 

, Climate class— 

3 

3/ 

,Slope class— 

Fuel model-^ 

,Last frost— ^ 

.Grass type— ^ 

; annual 

, perennial 

Year begin 

1960 jYear end 1977 

,Date begin 

0501 

,Date end HOI 


Site Adjustment Factors (if any) : 

Aspect ( l=north, 2=east, 3=south, 4=west ), Site elevation ft. 

Canopy cover ( l^open, 2=closed ) 


Duff/Soil Horizon Information [if Duff Moisture selected. See User's Guide. Appendix D) : 

I _T^i^_e Thickness ***********^^^*.*******^*^^*^^**^^^^^*^^^^^^^^^^^*^*^^^^^ 

* 

1 ^cm * U Use up to 80 characters 

* 

2 ^cm * y See User's Guide, appendix C 

* 

5 cm * y See User's Guide, appendix B 

•* 

4 cm * y For NFDRS indicies only, See User's Guide, 

^ , appendix A 

5 cm * y For NFDRS indices only 

A***'**************************************************** 

Prescription Factor Selections (Check and set limits for up to 15 factors.) : 

Preferable Rx Acceptable Rx 

Factor Minimum Maximum Minimum Maximum 

^State of the weather 

X T emperature (deg. F) 60 80 

X Relative humidity (%) 20 20 55 

^IVind direction (8 point) 

X W ind speed (mi/h) , y ^ ^ 

^(ax temperature (24 h, deg, F) 

_Min temperature (24 h, deg. F) 

_Max relative humidity (24 h, %) ______ 

Niin relative humidity (24 h, %) ______ 

^Days since last precipitation 

Precip amount (24 h, 0.01 in) 

1 hour fuel moisture (%); 

10 hour fuel moisture . ' , 

^NFDRS ERC. ............ . ___ ____ ___ 

^NFDRS Bl. ...... ___ _____ 

Duff moisture (24 h average, %) 


Exhibit 19. --User information sheet for one prescription example. 
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PROGRAM RxSURN: RUM MO. I OISTRICTJ FIRELA8 rORESTJ MONTANA PAGE NO, I 


o **•»»*»••»*#**»»*»»•**»**»♦»»*«»#«»*••»***•*»»*»*«**»•*****»******************• *'*********^ 
• • 

* DEM.O'JSTRATION of RXBURN output for PHILLPBBURG ranger STATION » 

* * 
«»##•»»*»**»*»*«»*»***»«**«»»*#»»»»»*»•»»»«»*»*««*» >nn»*»»»**»*»*****«»****#***«*^*******<^'***'' 

AFFIRMS STATION NAME* PHILUIPSBURG RS NATIONAL FOREST* MONTANA 

STATION! number* 2A3002 DISTRICT: FIRELA3 

ELEVATION! FT MSL* 5280 USER: BRAOSHAIff 


YEARS OF WEATHER DATA REQUESTED* 1960 TO 1977 <18 YEARS) 

SEASONAL OATES OF ANALYSIS * MAY 1 TO NOV 1 

TOTAU OAyS available * 2215 DAYS OVER' 16 YEARS 


PRESCRIPTION FACTOR SUMMARY 


» 

PRESCRPTIOM factors 

PREFERABLE! 

CONDITIONS 

ACCEPTABLE 

CONDITIONS 


« 


MINIMUM 

MAXIMUM 

MINIMUM 

MAXIMUM 

tt 

« 

1. temperature <0EG F) 

65 

75 

60 

80 

tt 

• 

2. RELATIVE HUMIDITY (») 

20 

30 

20 

55 


• 

tt 

3, WIND SPEED (MsH) 

A 

9 

0 

15 

» 

» 




PRESCRIPTION OCCURRENCE SUMMARY 

* PREFERABLE ACCEPTABLE UNACCEPTABLE 

» 


» 

OAYS per season WIThIN PRESCRIPTION 

8 

51 

80 

» 

(PERCENT) 

5k 

37* 

5B* 

» 

MONTH OF HIGHEST PRESCRITION FREQUENCY 

SEP 

JUU 

OCT 

» 

(PERCENT PROBABILITY) 

9k 

A5* 

71* 

» 

10 DAY PERIOD OF HIGHEST RX FREQUENCY BEGINS 

JJN 1 

JUL 1 

MAY 1 

» 


OCT 1 



» 

(PERCENT PROBABILITY) 

lOk 

57* 

7B* 


« 

•#•»»**•»««»»«»«»»»«««»«*««*»»»»»««•»»»••»»»»««<»»»»*»»»«»» 


Exhibit 20, --Program RXBURN prescription factor and occurrence summary output for one prescrip- 
tion example. 



Pe? 05RAM RKBU-^Nt ^IJN I 015TRICT: TIRElAB 


forest: MONTANA 


PAGE NO. 2 


PRESCRIPTION occurrence BY 10 DAY PERIOD AND MONTH 






PERIOD 

0 » 

preferable 

BAYS 

»* acceptahle 

DAYS »» 

unacceptable days 

0 


MONTH 

BEGINS 

NO. DAYS 

MEAN 

NUMBER 

percent 

MEAN 

NUMBER 

percent 

mean 

NUMBER 

PERCENT 

B 

» 

MAY 

1 

lOA 

0 

5 

5* 

1 

16 

17* 

5 

81 

7 9% 

0 

tt 

MAY 

1 1 

109 

0 

5 

Si 

2 

33 

30* 

A 

71 

65% 

0 


MAY 

21 

llB 

1 

B 

7i 

3 

AO 

3A* 

A 

70 

59% 

0 

4t 

MAY 

TOTAL 

331 

1 

Ifi 

Si 

6 

91 

27* 

lA 

222 

67% 

0 

0 

{ 

« 

>«»»»«« 

JIJN 

««■»»»»»» 

1 

1 in 

« # 0 fl- tt 

1 

BttB B »» 

1 1 

B 00 « * * tt 

10% 

BBB »Btt< 

3 

>0000000 

50 

000000000 

45% 

B BBBt 

3 

>0000001 

49 

> BB tt a 0 B 0 t 

A 5% 

» 0 

0 

It 

JUN 

1 1 

109 

0 

A 

A% 

2 

39 

3 6% 

A 

66 

61% 

0 

« 

JUN 

21 

1 OS 

0 

6 

6% 

3 

AS 

A2% 

3 

55 

52% 

0 

it 

it 

JUN 

TOTAL 

325 

1 

21 

6% 

8 

13A 

Al* 

11 

170 

52% 

0 

0 

»i 

it 

»» 0 

JUL‘ 

1 

133 

0 0 000 

0 

* t» B B « # tt 

3 

U B ■» B B B » 

?.i 

0 0 0 0004 

5 

» BB BBBBB 

78 

00 4> 000000 

57% 

BBBBt 

A 

»000000l 

57 

tBBBBBBBt 

Al% 

t 0 

0 

» 

JU., 

11 

150 

1 

8 

Si 

A 

62 

Al% 

5 

90 

53* 

0 

ft 

JUL 

21 

1^5 

0 

5 

3% 

A 

63 

39* 

6 

97 

59% 

0 

» 

JUL’ 

TOTAL 

asb 

1 

16 

A% 

13 

203 

A5% 

15 

23A 

52% 

B 

»tyintitititit<tititittntitititttttititttitintitttitint0it 


» 

AU3 

1 

159 

0 

7 

A% 

A 

66 

A2* 

5 

96 

5A% 

0 

» 

AUG 

1 1 

1A6 

0 

3 

?.i 

A 

56 

39* 

5 

97 

60% 

fi 

9 

AUG 

21 

160 

1 

10 

hi 

A 

67 

A2* 

5 

93 

52% 

0 

tt 

« 

AUG 

TOTAL 

A6S 

1 

20 

hi 

1? 

189 

Al* 

16 

256 

55% 

0 

0 

t 

t«Btt »» » 

SEP 

) 

» »»»« 

137 

0 0 0 0 0 

1 

12 

»BB#»BB 

9% 

BBB BBB< 

3 

»BBBB»BB 

55 

BBBBBBBBB 

AO* 

0 0001 

4 

0 0 00000! 

70 

BBBBBBBO! 

51% 

i B 

B 

tf 

SEP 

U 

129 

1 

1 1 

9% 

3 

A5 

35* 

5 

73 

57% 

0 


SEP 

21 

117 

1 

1 1 

9% 

2 

39 

33* 

A 

67 

57% 

B 


SEP 

TOTAL 

303 

2 

3A 

9% 

9 

139 

36* 

13 

210 

55% 

0 




0 

ocr 

1 

90 

1 

9 

10% 

1 

20 

22% 

A 

61 

68* 

0 

0 

OCT 

11 

90 

0 

3 

3* 

1 

21 

2 3% 

A 

66 

73* 

0 

0 

OCT 

21 

79 

0 

0 

0* 

1 

22 

29% 

A 

56 

72* 

0 

0 

OCT 

TOTAL 

259 

1 

1 2 

5* 

A 

63 

2A% 

11 

1B3 

71* 

0 


B »«»«»»»«#»!» «•»»»»»««»»«»«« »»»»«* ***»»»»»»*» »»»****#» 


NOV 


TOTAL 


m 


0% 


0 % 


» TOTAL 


TOTAL 


221s 


121 


Si 


51 


fll9 


37* 


30 1275 


53« 




Exhibit 21, --Program RXBURN prescription run length summary output for one prescription example, 



P?»03RAM RxBUJN: RUN NOt 1 DISTRICTS FJRELAR 


forest: mdmtana 


PAGE NO. 3 


PRESCRIPTION RUN LENGTH SUMMARY 




* MONTH 

B — 

* MAT 

* MAT 

* MAT 

* MAY 


*I> preferable day runs »« ACCEDTABLE day runs 


PERIOD 

BEGINS 

1 

I I 
21 

TOTAL 


mean 


» PERCENTILES * 
?5TH MEDIAN 75TH 


MEAN 


UNACCEPTABLE DAY RUNS 
DERCENTILES * » PERCENTILES * 

?5TH median 75TH MEAN P5TH MEDIAN 75TH 


JUN 

JUN 

JUN 

JUN 


1 

1 1 
21 

TOTAL 


JJ>‘ 

JUw- 

JUw 

JU-I 


1 

n 

21 

TOTAL 


AUS 
A US 
AU3 
AUS 


1 

n 

21 

TOTAL 


SEP 

SEP 

5E=> 

SE=» 


1 

11 

21 

TOTAL 


OCT 

OCT 

OCT 

OCT 


I 

1 1 
21 

TOTAL 


* NOV TOTAL 00000 00 0 0 0 0 0» 

* » 


Exhibit 22. --Program RXBURN prescription occurrence by 10-day period and month output for one 

prescription example. 



p:?039AM RxHU^N: 'JO 


1 DISTRICT: FIRElAR 


"OREST: MO^JTANA 


RAGE 'JO, A 


FROBA31LITY 0*^ MEETING PRESCRIPTION 1, 2, AW 3 DAYS IN THE FUTURE 




MONTH: MAY 


todays 

cond 

tt t» » 

PREF 

TOMORROtJ 

ACCP 

UNAC 

PREF 

2 days 

ACCP 

Btt » ft 

UNAC 

ftftftft 

pRFf 

3 DAYS 
ACCP 

ftftftft 

JNAC 

'J DAYS 

RREE 

1 7 ^ 

50»i 

33% 

9% 

30% 

53% 

7% 

33% 

61% 

PREF IB 

ACCP 

l?i 


41% 

8% 

35% 

5S% 

7% 

31% 

62% 

ACCP 95 

JNAC 

27> 

1 B?; 

80% 

4% 

?4% 

7?% 

5% 

2S% 

60% 

UNAC 215 


month; JUN 


TODAYS 

COnD 

ft ft 0 

PREF 

tomorrow 

ACCP 

Bftft 

UNAC 

ftftftft 

PREF 

2 days 

ACCP 

ftftftft 

UNAC 

ftftftft 

PRFF 

3 DAYS 
ACCP 

ftftftft 

JNAC 

N DAYS 

=REF 

20% 

60% 

20% 

10% 

51% 

39% 

H% 

43% 

47% 

PREF 20 

ACCP 

9% 

56% 

35% 

8% 

47% 

46% 

7% 

43% 

49% 

ACCP 132 

JNAC 

3% 

?8% 

69% 

5% 

37% 

59% 

6% 

40% 

54% 

UNAC 173 


month: JUL 


TODAYS 

cond 

ftftft 

PREF 

tomorrow 

ACCP 

ft ft* 

UNAC 

ftftftft 

PREF 

2 DAYS 
ACCP 

ftftftft 

UNAC 

ftftftft 

PREF 

3 DAYS 
ACCP 

ftftftft 

JNAC 

N DAYS 

=>REF 

0% 

75% 

25* 

4% 

48% 

4 9% 

4% 

45% 

51% 

PREF 16 

ACCP 

4% 

52% 

44% 

4% 

46% 

51% 

4% 

4 5% 

52% 

ACCP 205 

JNAC 

3% 

36% 

61% 

3% 

43% 

54% 

4% 

44% 

52% 

UNAC 227 


lixhibit 23 . -“Program RXBURN probability of meeting prescription in the future output for one 

prescription example. 




This option has one restriction: parameters not computed in the first directive block wil 
not be available for analysis in subsequent blocks. This applies only to National Fire Danger 
Rating System (NFDRS) indices, fuel moisture values, and duff moisture computations. Fuel 
moisture is computed if either fuel moisture or an NFDRS index is requested. NFDRS indices 
and duff moisture are computed only when requested. NFDRS fuel models and site adjustments 
cannot, therefore, be altered after the initial directive block. The following example shows 
how to analyze four prescriptions at the same station. The site adjustment option is used in 
this example. 

Example of Multiple Prescription Analysis 

card columns 

1 2 3 4 5 6 78 

01234567890123456789012345678901234567890123456789012345678901234567890. . .0 


@RUN 

OASG/A WEATHER. 

@USE 15., WEATHER. 
@ASG,T 2. 

@ASG,A CSSG*R1LIB. 

@XQT CSSG*R1LIB,RXBURN 


first 1 


directive 


block 


01 

STATION 

ANV STATION 123456 2345 45 H 3 P 3 0615 T T 

YEARS 1900 1978 

DATES 0101 1215 

ACTIVITY 

DEMONSTRATION OF MULTIPLE PRESCRIPTION ANALYSIS 
IDENTIFY 

LARRY BRADSHAW FIRE LAB MISSOULA 

PRESCRIBE 01 

NFDRS ERC 2 4 1 10 


2 4500. 1 


RUN 



01 


second 


directive 


STATION 

I SAME STATION 
'years 1900 
DATES 0101 
PRESCRIBE 01 


block 


NFDRS ERC 
RUN 


123456 2345 45 FI 3 P 3 0615 T T 2 4500. 1 

1978 

1215 


4 8 4 15 


third 

directive 


01 

PRESCRIBE 01 

WIND SPEED 


block 


RUN 


13 18 10 20 


fourth 

directive 

block 


01 

■PRESCRIBE 03 
I WIND DIRECTION 

' WIND SPEED 

MAX TEMPERATURE 


RUN 


D W S NW 

4 8 2 12 

65 72 60 78 


@EOF 

@F1N 

Error Messages 

^ • No recognizable input cards ~ Incorrect input stream - Program Aborted . 

Cause: Misspelled control word on a control card, or control card word not beginning in 
column 1, 

least one option is incorrect or was started in the wrong column - Program Aborted . 

Cause; Misspelled option after the PRESCRIBE control card, or option card did not begin 
in column 6, 

P^f^QTence between site and AFFIRMS station greater than 2000 feet, no adjustments made , 
r- Self-explanatory. 
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Output Quantities 

For each station and/or prescription analysis in a single RXBURN run, approximately five 
pages of output are produced, with a maximum of nine for a full 12-month analysis. 


Cost Estimates 

For a typical RXBURN run (one station, 5- to 6-month analysis, three to four prescription 
parameters) a user can expect costs and resource use as outlined below. 


Run priority 
DEMAND 
L 
N 
P 


Cost 

$4.00 to $5.00 
$2.00 to $2.50 
$1.00 to $1.50 
$0.75 to $1.00 


CAU (sec ) 
8 to 9 
8 to 9 
8 to 9 
8 to 9 


Resource time 
10 to 11 
10 to 11 
10 to 11 
10 to 11 
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